home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / dlas2.z / dlas2
Encoding:
Text File  |  2002-10-03  |  3.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. DDDDLLLLAAAASSSS2222((((3333SSSS))))                                                            DDDDLLLLAAAASSSS2222((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      DLAS2 - compute the singular values of the 2-by-2 matrix [ F G ] [ 0 H ]
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      SUBROUTINE DLAS2( F, G, H, SSMIN, SSMAX )
  13.  
  14.          DOUBLE        PRECISION F, G, H, SSMAX, SSMIN
  15.  
  16. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  17.      These routines are part of the SCSL Scientific Library and can be loaded
  18.      using either the -lscs or the -lscs_mp option.  The -lscs_mp option
  19.      directs the linker to use the multi-processor version of the library.
  20.  
  21.      When linking to SCSL with -lscs or -lscs_mp, the default integer size is
  22.      4 bytes (32 bits). Another version of SCSL is available in which integers
  23.      are 8 bytes (64 bits).  This version allows the user access to larger
  24.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  25.      by using the -lscs_i8 option or the -lscs_i8_mp option. A program may use
  26.      only one of the two versions; 4-byte integer and 8-byte integer library
  27.      calls cannot be mixed.
  28.  
  29. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  30.      DLAS2 computes the singular values of the 2-by-2 matrix [ F G ] [ 0 H ].
  31.      On return, SSMIN is the smaller singular value and SSMAX is the larger
  32.      singular value.
  33.  
  34.  
  35. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  36.      F       (input) DOUBLE PRECISION
  37.              The (1,1) element of the 2-by-2 matrix.
  38.  
  39.      G       (input) DOUBLE PRECISION
  40.              The (1,2) element of the 2-by-2 matrix.
  41.  
  42.      H       (input) DOUBLE PRECISION
  43.              The (2,2) element of the 2-by-2 matrix.
  44.  
  45.      SSMIN   (output) DOUBLE PRECISION
  46.              The smaller singular value.
  47.  
  48.      SSMAX   (output) DOUBLE PRECISION
  49.              The larger singular value.
  50.  
  51. FFFFUUUURRRRTTTTHHHHEEEERRRR DDDDEEEETTTTAAAAIIIILLLLSSSS
  52.      Barring over/underflow, all output quantities are correct to within a few
  53.      units in the last place (ulps), even in the absence of a guard digit in
  54.      addition/subtraction.
  55.  
  56.      In IEEE arithmetic, the code works correctly if one matrix element is
  57.      infinite.
  58.  
  59.      Overflow will not occur unless the largest singular value itself
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDLLLLAAAASSSS2222((((3333SSSS))))                                                            DDDDLLLLAAAASSSS2222((((3333SSSS))))
  71.  
  72.  
  73.  
  74.      overflows, or is within a few ulps of overflow. (On machines with partial
  75.      overflow, like the Cray, overflow may occur if the largest singular value
  76.      is within a factor of 2 of overflow.)
  77.  
  78.      Underflow is harmless if underflow is gradual. Otherwise, results may
  79.      correspond to a matrix modified by perturbations of size near the
  80.      underflow threshold.
  81.  
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      INTRO_LAPACK(3S), INTRO_SCSL(3S)
  85.  
  86.      This man page is available only online.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.